.TH "nvme_identify_primary_ctrl" 9 "nvme_identify_primary_ctrl" "July 2025" "libnvme API manual" LINUX
.SH NAME
nvme_identify_primary_ctrl \- Retrieve NVMe Primary Controller identification
.SH SYNOPSIS
.B "int" nvme_identify_primary_ctrl
.BI "(int fd "  ","
.BI "__u16 cntid "  ","
.BI "struct nvme_primary_ctrl_cap *cap "  ");"
.SH ARGUMENTS
.IP "fd" 12
File descriptor of nvme device
.IP "cntid" 12
Return controllers starting at this identifier
.IP "cap" 12
User space destination buffer address to transfer the data
.SH "DESCRIPTION"
See \fIstruct nvme_primary_ctrl_cap\fP for the definition of the returned structure, \fIcap\fP.
.SH "RETURN"
The nvme command status if a response was received (see
\fIenum nvme_status_field\fP) or -1 with errno set otherwise.
